服务器销售列表
本文说明智简魔方 DCIM 系统中“服务器销售列表”相关的接口或函数信息,供开发人员在集成、调用和排查问题时参考。
概述
查询系统下的所有符合条件的服务器销售信息
URL
/index.php?m=api&a=overview请求参数
| 字段名 | 变量名 | 必填 | 类型 | 描述 |
|---|---|---|---|---|
| 搜索类型 | search | 否 | string | 搜索类型(house:机房 ID,cabinet:机柜 ID,power:电源状态,status:销售状态,key:IP 或者物理标签或者内部标签或者 MAC 地址,highgrade:高级搜索,special:特殊搜索) |
| 搜索内容 | key | 否 | string | 对服务器销售信息的搜索,搜索类型为 house 时,调用/index.php?m=api&a=getHouse 获取由 ID(机房 ID)和 name(机房名称)组成的二维数组,选择传递 ID;搜索类型为 cabinet 时,调用/index.php?m=api&a=getCabinet 获取由 ID(机柜 ID)和 name(机柜名称)组成的二维数组,选择传递 ID;搜索类型为电源状态时,选择(on:开机,off:关机,error:未知)其一传递;搜索类型为销售状态时,选择(1:空闲,2:到期,3:正常,4:故障)其一传递 |
| 分页数量 | listpages | 否 | int | 每页显示的数据的数量 |
| 排序类型 | orderby | 否 | string | 用来排序的字段 |
| 排序规则 | sorting | 否 | string | 升序 asc 降序 desc |
| 数据偏移量 | offset | 否 | int | 返回数据的偏移指针,与分页数量结合使用 |
| 服务器类型 | type | 否 | string | 搜索的服务器类型,(all:全部状态) |
| cpu | cpu | 否 | array | 高级/特殊搜索参数(search 的值为 highgrade 或 special 时使用),CPU 的 ID,调用/index.php?m=api&a=getCpu 获取由 ID(CPU ID)和 name(CPU 名称)组成的二维数组 |
| cpu 数量 | cpu_num | 否 | int | 高级/特殊搜索参数(search 的值为 highgrade 或 special 时使用),CPU 数量 |
| 内存 | ram | 否 | array,search 为 special 时为二维数组 | 高级/特殊搜索参数(search 的值为 highgrade 或 special 时使用),内存 ID,调用/index.php?m=api&a=getRam 获取由 ID(内存 ID)和 name(内存名称)组成的二维数组 |
| 内存数量 | ram_num | 否 | search为highgrade时为int search为special时为array | 高级/特殊搜索参数(search的值为highgrade或special时使用),内存数量 search为special时,ram数组和ram_num数组的值根据下标一一对应代表搜索x个a/c,y个b/d |
| 硬盘 | disk | 否 | array,search 为 special 时为二维数组 | 高级/特殊搜索参数(search 的值为 highgrade 或 special 时使用),硬盘 ID,调用/index.php?m=api&a=getDisk 获取由 ID(硬盘 ID)和 name(硬盘名称)组成的二维数组 |
| 硬盘数量 | disk_num | 否 | search为highgrade时为int search为special时为array | 高级/特殊搜索参数(search的值为highgrade或special时使用),硬盘数量 search为special时,disk数组和disk_num数组的值根据下标一一对应代表搜索x个a/c,y个b/d |
| PCI | pci | 否 | array,search 为 special 时为二维数组 | 高级/特殊搜索参数(search 的值为 highgrade 或 special 时使用),PCI ID,调用/index.php?m=api&a=getPci 获取由 ID(PCI ID)和 name(PCI 名称)组成的二维数组 |
| PCI 数量 | pci_num | 否 | search为highgrade时为int search为special时为array | 高级/特殊搜索参数(search的值为highgrade或special时使用),PCI 数量 search为special时,pci数组和pci_num数组的值根据下标一一对应代表搜索x个a/c,y个b/d |
| IP | ip | 否 | string | 高级搜索参数(search 的值为 highgrade 时使用),IP 地址 |
| IP 数量 | ip_num | 否 | int | 高级搜索参数(search 的值为 highgrade 时使用),IP 数量 |
| 电源状态 | power | 否 | array | 高级搜索参数(search 的值为 highgrade 时使用),电源状态(on:开机,off:关机,error:未知) |
| 销售状态 | status | 否 | array | 高级搜索参数(search 的值为 highgrade 时使用),销售状态(1:空闲,2:到期,3:正常,4:故障) |
| 销售类型 | sales | 是 | string | 搜索的销售类型(rent:租用,trust:托管) |
| 内存容量 | ram_capacity | 否 | int | 特殊搜索参数(search 的值为 special 时使用),内存容量 |
| 过滤规则 | filter | 否 | int | 特殊搜索参数(search 的值为 special 时使用),0:一致,1:包含 |
返回参数
| 字段名 | 变量名 | 类型 | 描述 |
|---|---|---|---|
| 服务器销售列表 | listing | arrayid:服务器软件 IDhid:服务器硬件 IDwltag:物理标签nbtag:内部标签cpu:CPU 数组ram:内存数组disk:硬盘数组pci:PCI 设备数组time:上架时间type:类型(1:租用,2:自用,5:托管,8:机柜客户)power:电源状态intranet_id:内网 IDlock:MAC 锁定状态(0:不锁定,1:锁定)mac:MAC 地址ipmi_name:IPMI 用户名ipmi_pass:IPMI 密码power_msg:电源状态信息zhuip:主 IPsubnetmask:子网掩码gateway:网关ipmi_ip:IPMI IPvlan:连接交换机可用 VLANswitch_id:连接交换机 IDswitch_num:连接交换机端口号switch_num_name:连接交换机端口名称in_bw:连接交换机端口入口带宽out_bw:连接交换机端口出口带宽vlanid:连接交换机端口 VLANvlanport_mac:连接交换机端口 MAC 地址数组mac_diff:MAC 地址是否与交换机端口记录不同typename:硬件型号名称pid:连接 PDU 设备 IDpdu:连接 PDU 设备名称pdu_num:连接 PDU 设备端口showtype:PDU 端口显示类型ipmi_support:是否支持 IPMI 控制cname:所属机柜名称house:机房 IDhouse_name:机房名称osname:操作系统os_id:操作系统 IDos_group_id:操作系统分组 IDosusername:系统账号ospassword:系统密码sum:分配 IP 总数ip:分配 IP 数组productid:产品 IDclientid:客户 IDemail:客户邮箱token:密钥 | 根据查询条件查询到的所有服务器销售数据 |
| 服务器销售总数 | sum | int | 系统内服务器销售数据的总数 |
| 分页数量 | listpages | int | 每页显示的数据的数量 |
| 搜索类型 | search | string | 搜索类型 |
| 搜索内容 | key | string | 自定义的搜索内容 |
| 排序类型 | orderby | string | 用来排序的字段 |
| 排序规则 | sorting | string | 升序 asc 降序 desc |
| 数据偏移量 | offset | int | 返回数据的偏移指针,与分页数量结合使用 |
| 服务器类型 | type | string | 搜索的服务器类型 |
| 提示信息 | msg | string | 出错提示信息 |
| 状态 | status | string | success 成功 error 失败 |